Chuyển tới nội dung chính

Webhook Trạng Thái VA

API VA Flow

Đường dẫn

  • URL: Partner cung cấp URL
  • Method: POST
  • Mô tả: Webhook này được kích hoạt khi có cập nhật trạng thái trên Virtual Account

Request

Bảng Request

Tham sốKiểu dữ liệu + Độ dàiBắt buộcMô tả
request_idstring(50)Mã ID request duy nhất, định dạng đề xuất: MerchantCode+YYYYMMDDHHMMSS+UniqueId
request_timestring(19)Thời gian request theo định dạng: YYYY-MM-DD HH:MM:SS
reference_codestring(100)Mã tham chiếu của VA được quản lý trong hệ thống của bạn
statusstring(10)1: Hoạt động, 2: Không hoạt động
acc_nostring(22)Số tài khoản ngân hàng
reject_reasonstring(255)Trong trường hợp VA bị hủy kích hoạt, Baokim sẽ gửi lý do

Ví dụ Request

{
"request_id": "PARTNER12320231105123000ID01",
"request_time": "2023-11-05 12:30",
"reference_code": "ORDER1234567890123456789012345",
"status": 1,
"acc_no": "12345678901234567890",
}

Response

Bảng Response

Tham sốKiểu dữ liệu + Độ dàiBắt buộcMô tả
response_codeint(4)Mã lỗi từ Baokim theo Bảng Mã Lỗi
response_messagestring(100)Mô tả mã lỗi từ Baokim theo Bảng Mã Lỗi

Ví dụ Response

{
"response_code": 200,
"response_message": "Success"
}

Mã Lỗi

Mã ResponseThông báo Response
200Thành công
11Thất bại
101Lỗi Hệ thống